home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cat3 / c++ / ostream.z / ostream
Encoding:
Text File  |  1998-10-30  |  31.9 KB  |  331 lines

  1.  
  2.  
  3.  
  4. OOOOSSSSTTTTRRRREEEEAAAAMMMM((((3333CCCC++++++++))))                                                    OOOOSSSSTTTTRRRREEEEAAAAMMMM((((3333CCCC++++++++))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ostream - formatted and unformatted output
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_iiii_oooo_ssss_tttt_rrrr_eeee_aaaa_mmmm_...._hhhh_>>>>
  13.  
  14.      _tttt_yyyy_pppp_eeee_dddd_eeee_ffff _llll_oooo_nnnn_gggg _ssss_tttt_rrrr_eeee_aaaa_mmmm_oooo_ffff_ffff_,,,, _ssss_tttt_rrrr_eeee_aaaa_mmmm_pppp_oooo_ssss_;;;;
  15.      _cccc_llll_aaaa_ssss_ssss _iiii_oooo_ssss _{{{{
  16.      _pppp_uuuu_bbbb_llll_iiii_cccc_::::
  17.                _eeee_nnnn_uuuu_mmmm      _ssss_eeee_eeee_kkkk______dddd_iiii_rrrr _{{{{ _bbbb_eeee_gggg_,,,, _cccc_uuuu_rrrr_,,,, _eeee_nnnn_dddd _}}}}_;;;;
  18.                _eeee_nnnn_uuuu_mmmm      _oooo_pppp_eeee_nnnn______mmmm_oooo_dddd_eeee _{{{{ _iiii_nnnn_,,,, _oooo_uuuu_tttt_,,,, _aaaa_tttt_eeee_,,,, _aaaa_pppp_pppp_,,,, _tttt_rrrr_uuuu_nnnn_cccc_,,,, _nnnn_oooo_cccc_rrrr_eeee_aaaa_tttt_eeee_,,,, _nnnn_oooo_rrrr_eeee_pppp_llll_aaaa_cccc_eeee _}}}} _;;;;
  19.                _eeee_nnnn_uuuu_mmmm      _{{{{ _ssss_kkkk_iiii_pppp_wwww_ssss_====_0000_1111_,,,,
  20.                            _llll_eeee_ffff_tttt_====_0000_2222_,,,,  _rrrr_iiii_gggg_hhhh_tttt_====_0000_4444_,,,, _iiii_nnnn_tttt_eeee_rrrr_nnnn_aaaa_llll_====_0000_1111_0000_,,,,
  21.                            _dddd_eeee_cccc_====_0000_2222_0000_,,,, _oooo_cccc_tttt_====_0000_4444_0000_,,,, _hhhh_eeee_xxxx_====_0000_1111_0000_0000_,,,,
  22.                            _ssss_hhhh_oooo_wwww_bbbb_aaaa_ssss_eeee_====_0000_2222_0000_0000_,,,, _ssss_hhhh_oooo_wwww_pppp_oooo_iiii_nnnn_tttt_====_0000_4444_0000_0000_,,,, _uuuu_pppp_pppp_eeee_rrrr_cccc_aaaa_ssss_eeee_====_0000_1111_0000_0000_0000_,,,, _ssss_hhhh_oooo_wwww_pppp_oooo_ssss_====_0000_2222_0000_0000_0000_,,,,
  23.                            _ssss_cccc_iiii_eeee_nnnn_tttt_iiii_ffff_iiii_cccc_====_0000_4444_0000_0000_0000_,,,, _ffff_iiii_xxxx_eeee_dddd_====_0000_1111_0000_0000_0000_0000_,,,,
  24.                            _uuuu_nnnn_iiii_tttt_bbbb_uuuu_ffff_====_0000_2222_0000_0000_0000_0000_,,,, _ssss_tttt_dddd_iiii_oooo_====_0000_4444_0000_0000_0000_0000 _}}}}_;;;;
  25.                _////_//// _aaaa_nnnn_dddd _llll_oooo_tttt_ssss _oooo_ffff _oooo_tttt_hhhh_eeee_rrrr _ssss_tttt_uuuu_ffff_ffff_,,,, _ssss_eeee_eeee _iiii_oooo_ssss_((((_3333_CCCC_++++_++++_)))) _...._...._....
  26.      _}}}} _;;;;
  27.  
  28.      _cccc_llll_aaaa_ssss_ssss _oooo_ssss_tttt_rrrr_eeee_aaaa_mmmm _:::: _pppp_uuuu_bbbb_llll_iiii_cccc _iiii_oooo_ssss _{{{{
  29.      _pppp_uuuu_bbbb_llll_iiii_cccc_::::
  30.                          _oooo_ssss_tttt_rrrr_eeee_aaaa_mmmm_((((_ssss_tttt_rrrr_eeee_aaaa_mmmm_bbbb_uuuu_ffff_****_))))_;;;;
  31.                _oooo_ssss_tttt_rrrr_eeee_aaaa_mmmm_&&&&  _ffff_llll_uuuu_ssss_hhhh_((((_))))_;;;;
  32.                _iiii_nnnn_tttt       _oooo_pppp_ffff_xxxx_((((_))))_;;;;
  33.                _oooo_ssss_tttt_rrrr_eeee_aaaa_mmmm_&&&&  _pppp_uuuu_tttt_((((_cccc_hhhh_aaaa_rrrr_))))_;;;;
  34.                _oooo_ssss_tttt_rrrr_eeee_aaaa_mmmm_&&&&  _ssss_eeee_eeee_kkkk_pppp_((((_ssss_tttt_rrrr_eeee_aaaa_mmmm_pppp_oooo_ssss_))))_;;;;
  35.                _oooo_ssss_tttt_rrrr_eeee_aaaa_mmmm_&&&&  _ssss_eeee_eeee_kkkk_pppp_((((_ssss_tttt_rrrr_eeee_aaaa_mmmm_oooo_ffff_ffff_,,,, _ssss_eeee_eeee_kkkk______dddd_iiii_rrrr_))))_;;;;
  36.                _ssss_tttt_rrrr_eeee_aaaa_mmmm_pppp_oooo_ssss _tttt_eeee_llll_llll_pppp_((((_))))_;;;;
  37.                _oooo_ssss_tttt_rrrr_eeee_aaaa_mmmm_&&&&  _wwww_rrrr_iiii_tttt_eeee_((((_cccc_oooo_nnnn_ssss_tttt _cccc_hhhh_aaaa_rrrr_**** _pppp_tttt_rrrr_,,,, _iiii_nnnn_tttt _nnnn_))))_;;;;
  38.                _oooo_ssss_tttt_rrrr_eeee_aaaa_mmmm_&&&&  _wwww_rrrr_iiii_tttt_eeee_((((_cccc_oooo_nnnn_ssss_tttt _uuuu_nnnn_ssss_iiii_gggg_nnnn_eeee_dddd _cccc_hhhh_aaaa_rrrr_**** _pppp_tttt_rrrr_,,,, _iiii_nnnn_tttt _nnnn_))))_;;;;
  39.                _oooo_ssss_tttt_rrrr_eeee_aaaa_mmmm_&&&&  _oooo_pppp_eeee_rrrr_aaaa_tttt_oooo_rrrr_<<<<_<<<<_((((_cccc_oooo_nnnn_ssss_tttt _cccc_hhhh_aaaa_rrrr_****_))))_;;;;
  40.                _oooo_ssss_tttt_rrrr_eeee_aaaa_mmmm_&&&&  _oooo_pppp_eeee_rrrr_aaaa_tttt_oooo_rrrr_<<<<_<<<<_((((_cccc_hhhh_aaaa_rrrr_))))_;;;;
  41.                _oooo_ssss_tttt_rrrr_eeee_aaaa_mmmm_&&&&  _oooo_pppp_eeee_rrrr_aaaa_tttt_oooo_rrrr_<<<<_<<<<_((((_ssss_hhhh_oooo_rrrr_tttt_))))_;;;;
  42.                _oooo_ssss_tttt_rrrr_eeee_aaaa_mmmm_&&&&  _oooo_pppp_eeee_rrrr_aaaa_tttt_oooo_rrrr_<<<<_<<<<_((((_iiii_nnnn_tttt_))))_;;;;
  43.                _oooo_ssss_tttt_rrrr_eeee_aaaa_mmmm_&&&&  _oooo_pppp_eeee_rrrr_aaaa_tttt_oooo_rrrr_<<<<_<<<<_((((_llll_oooo_nnnn_gggg_))))_;;;;
  44.                _oooo_ssss_tttt_rrrr_eeee_aaaa_mmmm_&&&&  _oooo_pppp_eeee_rrrr_aaaa_tttt_oooo_rrrr_<<<<_<<<<_((((_ffff_llll_oooo_aaaa_tttt_))))_;;;;
  45.                _oooo_ssss_tttt_rrrr_eeee_aaaa_mmmm_&&&&  _oooo_pppp_eeee_rrrr_aaaa_tttt_oooo_rrrr_<<<<_<<<<_((((_dddd_oooo_uuuu_bbbb_llll_eeee_))))_;;;;
  46.                _oooo_ssss_tttt_rrrr_eeee_aaaa_mmmm_&&&&  _oooo_pppp_eeee_rrrr_aaaa_tttt_oooo_rrrr_<<<<_<<<<_((((_uuuu_nnnn_ssss_iiii_gggg_nnnn_eeee_dddd _cccc_hhhh_aaaa_rrrr_))))_;;;;
  47.                _oooo_ssss_tttt_rrrr_eeee_aaaa_mmmm_&&&&  _oooo_pppp_eeee_rrrr_aaaa_tttt_oooo_rrrr_<<<<_<<<<_((((_uuuu_nnnn_ssss_iiii_gggg_nnnn_eeee_dddd _ssss_hhhh_oooo_rrrr_tttt_))))_;;;;
  48.                _oooo_ssss_tttt_rrrr_eeee_aaaa_mmmm_&&&&  _oooo_pppp_eeee_rrrr_aaaa_tttt_oooo_rrrr_<<<<_<<<<_((((_uuuu_nnnn_ssss_iiii_gggg_nnnn_eeee_dddd _iiii_nnnn_tttt_))))_;;;;
  49.                _oooo_ssss_tttt_rrrr_eeee_aaaa_mmmm_&&&&  _oooo_pppp_eeee_rrrr_aaaa_tttt_oooo_rrrr_<<<<_<<<<_((((_uuuu_nnnn_ssss_iiii_gggg_nnnn_eeee_dddd _llll_oooo_nnnn_gggg_))))_;;;;
  50.                _oooo_ssss_tttt_rrrr_eeee_aaaa_mmmm_&&&&  _oooo_pppp_eeee_rrrr_aaaa_tttt_oooo_rrrr_<<<<_<<<<_((((_vvvv_oooo_iiii_dddd_****_))))_;;;;
  51.                _oooo_ssss_tttt_rrrr_eeee_aaaa_mmmm_&&&&  _oooo_pppp_eeee_rrrr_aaaa_tttt_oooo_rrrr_<<<<_<<<<_((((_ssss_tttt_rrrr_eeee_aaaa_mmmm_bbbb_uuuu_ffff_****_))))_;;;;
  52.                _oooo_ssss_tttt_rrrr_eeee_aaaa_mmmm_&&&&  _oooo_pppp_eeee_rrrr_aaaa_tttt_oooo_rrrr_<<<<_<<<<_((((_oooo_ssss_tttt_rrrr_eeee_aaaa_mmmm_&&&& _((((_****_))))_((((_oooo_ssss_tttt_rrrr_eeee_aaaa_mmmm_&&&&_))))_))))_;;;;
  53.                _oooo_ssss_tttt_rrrr_eeee_aaaa_mmmm_&&&&  _oooo_pppp_eeee_rrrr_aaaa_tttt_oooo_rrrr_<<<<_<<<<_((((_iiii_oooo_ssss_&&&& _((((_****_))))_((((_iiii_oooo_ssss_&&&&_))))_))))_;;;;
  54.      _}}}}_;;;;
  55.  
  56.      _cccc_llll_aaaa_ssss_ssss _oooo_ssss_tttt_rrrr_eeee_aaaa_mmmm______wwww_iiii_tttt_hhhh_aaaa_ssss_ssss_iiii_gggg_nnnn _{{{{
  57.                          _oooo_ssss_tttt_rrrr_eeee_aaaa_mmmm______wwww_iiii_tttt_hhhh_aaaa_ssss_ssss_iiii_gggg_nnnn_((((_))))_;;;;
  58.                _iiii_ssss_tttt_rrrr_eeee_aaaa_mmmm_&&&&  _oooo_pppp_eeee_rrrr_aaaa_tttt_oooo_rrrr_====_((((_iiii_ssss_tttt_rrrr_eeee_aaaa_mmmm_&&&&_))))_;;;;
  59.                _iiii_ssss_tttt_rrrr_eeee_aaaa_mmmm_&&&&  _oooo_pppp_eeee_rrrr_aaaa_tttt_oooo_rrrr_====_((((_ssss_tttt_rrrr_eeee_aaaa_mmmm_bbbb_uuuu_ffff_****_))))_;;;;
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. OOOOSSSSTTTTRRRREEEEAAAAMMMM((((3333CCCC++++++++))))                                                    OOOOSSSSTTTTRRRREEEEAAAAMMMM((((3333CCCC++++++++))))
  71.  
  72.  
  73.  
  74.      _}}}}_;;;;
  75.  
  76.      _eeee_xxxx_tttt_eeee_rrrr_nnnn _oooo_ssss_tttt_rrrr_eeee_aaaa_mmmm______wwww_iiii_tttt_hhhh_aaaa_ssss_ssss_iiii_gggg_nnnn _cccc_oooo_uuuu_tttt_;;;;
  77.      _eeee_xxxx_tttt_eeee_rrrr_nnnn _oooo_ssss_tttt_rrrr_eeee_aaaa_mmmm______wwww_iiii_tttt_hhhh_aaaa_ssss_ssss_iiii_gggg_nnnn _cccc_eeee_rrrr_rrrr_;;;;
  78.      _eeee_xxxx_tttt_eeee_rrrr_nnnn _oooo_ssss_tttt_rrrr_eeee_aaaa_mmmm______wwww_iiii_tttt_hhhh_aaaa_ssss_ssss_iiii_gggg_nnnn _cccc_llll_oooo_gggg_;;;;
  79.  
  80.      _oooo_ssss_tttt_rrrr_eeee_aaaa_mmmm_&&&&  _eeee_nnnn_dddd_llll_((((_oooo_ssss_tttt_rrrr_eeee_aaaa_mmmm_&&&&_)))) _;;;;
  81.      _oooo_ssss_tttt_rrrr_eeee_aaaa_mmmm_&&&&  _eeee_nnnn_dddd_ssss_((((_oooo_ssss_tttt_rrrr_eeee_aaaa_mmmm_&&&&_)))) _;;;;
  82.      _oooo_ssss_tttt_rrrr_eeee_aaaa_mmmm_&&&&  _ffff_llll_uuuu_ssss_hhhh_((((_oooo_ssss_tttt_rrrr_eeee_aaaa_mmmm_&&&&_)))) _;;;;
  83.      _iiii_oooo_ssss_&&&&      _dddd_eeee_cccc_((((_iiii_oooo_ssss_&&&&_)))) _;;;;
  84.      _iiii_oooo_ssss_&&&&      _hhhh_eeee_xxxx_((((_iiii_oooo_ssss_&&&&_)))) _;;;;
  85.      _iiii_oooo_ssss_&&&&      _oooo_cccc_tttt_((((_iiii_oooo_ssss_&&&&_)))) _;;;;
  86.  
  87. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  88.      _oooo_ssss_tttt_rrrr_eeee_aaaa_mmmms support insertion (storing) into a _ssss_tttt_rrrr_eeee_aaaa_mmmm_bbbb_uuuu_ffff.  These are
  89.      commonly referred to as output operations.  The _oooo_ssss_tttt_rrrr_eeee_aaaa_mmmm member functions
  90.      and related functions are described below.
  91.  
  92.      In the following descriptions, assume:
  93.      - _o_u_t_s is an _oooo_ssss_tttt_rrrr_eeee_aaaa_mmmm.
  94.      - _o_u_t_s_w_a is an _oooo_ssss_tttt_rrrr_eeee_aaaa_mmmm______wwww_iiii_tttt_hhhh_aaaa_ssss_ssss_iiii_gggg_nnnn.
  95.      - _o_u_t_s_p is an _oooo_ssss_tttt_rrrr_eeee_aaaa_mmmm_****.
  96.      - _c is a _cccc_hhhh_aaaa_rrrr.
  97.      - _p_t_r is a _cccc_hhhh_aaaa_rrrr_**** or _uuuu_nnnn_ssss_iiii_gggg_nnnn_eeee_dddd _cccc_hhhh_aaaa_rrrr_****.
  98.      - _s_b is a _ssss_tttt_rrrr_eeee_aaaa_mmmm_bbbb_uuuu_ffff_****
  99.      - _i and _n are _iiii_nnnn_tttts.
  100.      - _p_o_s is a _ssss_tttt_rrrr_eeee_aaaa_mmmm_pppp_oooo_ssss.
  101.      - _o_f_f is a _ssss_tttt_rrrr_eeee_aaaa_mmmm_oooo_ffff_ffff.
  102.      - _d_i_r is a _ssss_eeee_eeee_kkkk______dddd_iiii_rrrr.
  103.      - _m_a_n_i_p is a function with type _oooo_ssss_tttt_rrrr_eeee_aaaa_mmmm_&&&& _((((_****_))))_((((_oooo_ssss_tttt_rrrr_eeee_aaaa_mmmm_&&&&_)))).
  104.  
  105.    CCCCoooonnnnssssttttrrrruuuuccccttttoooorrrrssss aaaannnndddd aaaassssssssiiiiggggnnnnmmmmeeeennnntttt::::
  106.           _oooo_ssss_tttt_rrrr_eeee_aaaa_mmmm_((((_s_b_))))
  107.                Initializes _iiii_oooo_ssss state variables and associates buffer _s_b with
  108.                the _oooo_ssss_tttt_rrrr_eeee_aaaa_mmmm.
  109.  
  110.           _oooo_ssss_tttt_rrrr_eeee_aaaa_mmmm______wwww_iiii_tttt_hhhh_aaaa_ssss_ssss_iiii_gggg_nnnn_((((_))))
  111.                Does no initialization.  This allows a file static variable of
  112.                this type (_cccc_oooo_uuuu_tttt, for example) to be used before it is
  113.                constructed, provided it is assigned to first.
  114.  
  115.           _o_u_t_s_w_a_====_s_b
  116.                Associates _s_b with _s_w_a and initializes the entire state of
  117.                _o_u_t_s_w_a.
  118.  
  119.           _i_n_s_w_a_====_i_n_s
  120.                Associates _i_n_s_----_>>>>_rrrr_dddd_bbbb_uuuu_ffff_((((_)))) with _s_w_a and initializes the entire
  121.                state of _o_u_t_s_w_a.
  122.  
  123.    OOOOuuuuttttppppuuuutttt pppprrrreeeeffffiiiixxxx ffffuuuunnnnccccttttiiiioooonnnn::::
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. OOOOSSSSTTTTRRRREEEEAAAAMMMM((((3333CCCC++++++++))))                                                    OOOOSSSSTTTTRRRREEEEAAAAMMMM((((3333CCCC++++++++))))
  137.  
  138.  
  139.  
  140.           _i_====_o_u_t_s_...._oooo_pppp_ffff_xxxx_((((_))))
  141.                If _o_u_t_s's error state is nonzero, returns immediately.  If
  142.                _o_u_t_s_...._tttt_iiii_eeee_((((_)))) is non-null, it is flushed.  Returns non-zero except
  143.                when _o_u_t_s's error state is nonzero.
  144.  
  145.    OOOOuuuuttttppppuuuutttt ssssuuuuffffffffiiiixxxx ffffuuuunnnnccccttttiiiioooonnnn::::
  146.           _oooo_ssss_ffff_xxxx_((((_))))
  147.                Performs ``suffix'' actions before returning from inserters.
  148.                If _iiii_oooo_ssss_::::_::::_uuuu_nnnn_iiii_tttt_bbbb_uuuu_ffff is set, _oooo_ssss_ffff_xxxx_((((_)))) flushes the _oooo_ssss_tttt_rrrr_eeee_aaaa_mmmm.  If
  149.                _iiii_oooo_ssss_::::_::::_ssss_tttt_dddd_iiii_oooo is set, _oooo_ssss_ffff_xxxx_((((_)))) flushes _ssss_tttt_dddd_oooo_uuuu_tttt and _ssss_tttt_dddd_eeee_rrrr_rrrr.
  150.  
  151.           _oooo_ssss_ffff_xxxx_((((_)))) is called by all predefined inserters, and should be called
  152.           by user-defined inserters as well, after any direct manipulation of
  153.           the _ssss_tttt_rrrr_eeee_aaaa_mmmm_bbbb_uuuu_ffff.  It is not called by the binary output functions.
  154.  
  155.    FFFFoooorrrrmmmmaaaatttttttteeeedddd oooouuuuttttppppuuuutttt ffffuuuunnnnccccttttiiiioooonnnnssss ((((iiiinnnnsssseeeerrrrtttteeeerrrrssss))))::::
  156.           _o_u_t_s_<<<<_<<<<_x
  157.                First calls _o_u_t_s_...._oooo_pppp_ffff_xxxx_((((_)))) and if that returns 0, does nothing.
  158.                Otherwise inserts a sequence of characters representing _x into
  159.                _o_u_t_s_...._rrrr_dddd_bbbb_uuuu_ffff_((((_)))).  Errors are indicated by setting the error state
  160.                of _o_u_t_s.  _o_u_t_s is always returned.
  161.  
  162.                _x is converted into a sequence of characters (its
  163.                representation) according to rules that depend on _x's type and
  164.                _o_u_t_s's format state flags and variables (see _iiii_oooo_ssss(3C++)).
  165.                Inserters are defined for the following types, with conversion
  166.                rules as described below:
  167.  
  168.                _cccc_hhhh_aaaa_rrrr_****
  169.                     The representation is the sequence of characters up to
  170.                     (but not including) the terminating null of the string _x
  171.                     points at.
  172.  
  173.                _a_n_y _i_n_t_e_g_r_a_l _t_y_p_e except _cccc_hhhh_aaaa_rrrr _a_n_d _uuuu_nnnn_ssss_iiii_gggg_nnnn_eeee_dddd _cccc_hhhh_aaaa_rrrr
  174.                     If _x is positive the representation contains a sequence of
  175.                     decimal, octal, or hexadecimal digits with no leading
  176.                     zeros according to whether _iiii_oooo_ssss_::::_::::_dddd_eeee_cccc, _iiii_oooo_ssss_::::_::::_oooo_cccc_tttt, or
  177.                     _iiii_oooo_ssss_::::_::::_hhhh_eeee_xxxx, respectively, is set in _iiii_oooo_ssss's format flags.  If
  178.                     none of those flags are set, conversion defaults to
  179.                     decimal.  If _x is zero, the representation is a single
  180.                     zero character(_0000).  If _x is negative, decimal conversion
  181.                     converts it to a minus sign (_----) followed by decimal
  182.                     digits.  If _x is positive and _iiii_oooo_ssss_::::_::::_ssss_hhhh_oooo_wwww_pppp_oooo_ssss is set, decimal
  183.                     conversion converts it to a plus sign (_++++) followed by
  184.                     decimal digits.  The other conversions treat all values as
  185.                     unsigned.  If _iiii_oooo_ssss_::::_::::_ssss_hhhh_oooo_wwww_bbbb_aaaa_ssss_eeee is set in _i_o_s's format flags,
  186.                     the hexadecimal representation contains _0000_xxxx before the
  187.                     hexadecimal digits, or _0000_XXXX if _iiii_oooo_ssss_::::_::::_uuuu_pppp_pppp_eeee_rrrr_cccc_aaaa_ssss_eeee is set.  If
  188.                     _iiii_oooo_ssss_::::_::::_ssss_hhhh_oooo_wwww_bbbb_aaaa_ssss_eeee is set, the octal representation contains a
  189.                     leading 0.
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202. OOOOSSSSTTTTRRRREEEEAAAAMMMM((((3333CCCC++++++++))))                                                    OOOOSSSSTTTTRRRREEEEAAAAMMMM((((3333CCCC++++++++))))
  203.  
  204.  
  205.  
  206.                _vvvv_oooo_iiii_dddd_****
  207.                     Pointers are converted to integral values and then
  208.                     converted to hexadecimal numbers as if _iiii_oooo_ssss_::::_::::_ssss_hhhh_oooo_wwww_bbbb_aaaa_ssss_eeee were
  209.                     set.
  210.  
  211.                _ffff_llll_oooo_aaaa_tttt, _dddd_oooo_uuuu_bbbb_llll_eeee
  212.                     The arguments are converted according to the current
  213.                     values of _o_u_t_s_...._pppp_rrrr_eeee_cccc_iiii_ssss_iiii_oooo_nnnn_((((_)))), _o_u_t_s_...._wwww_iiii_dddd_tttt_hhhh_((((_)))) and _o_u_t_s's format
  214.                     flags _iiii_oooo_ssss_::::_::::_ssss_cccc_iiii_eeee_nnnn_tttt_iiii_ffff_iiii_cccc, _iiii_oooo_ssss_::::_::::_ffff_iiii_xxxx_eeee_dddd, and _iiii_oooo_ssss_::::_::::_uuuu_pppp_pppp_eeee_rrrr_cccc_aaaa_ssss_eeee.
  215.                     (See _iiii_oooo_ssss(3C++).)  The default value for _o_u_t_s_...._pppp_rrrr_eeee_cccc_iiii_ssss_iiii_oooo_nnnn_((((_))))
  216.                     is 6.  If neither _iiii_oooo_ssss_::::_::::_ssss_cccc_iiii_eeee_nnnn_tttt_iiii_ffff_iiii_cccc nor _iiii_oooo_ssss_::::_::::_ffff_iiii_xxxx_eeee_dddd is set,
  217.                     either fixed or scientific notation is chosen for the
  218.                     representation, depending on the value of _x.
  219.  
  220.                _cccc_hhhh_aaaa_rrrr, _uuuu_nnnn_ssss_iiii_gggg_nnnn_eeee_dddd _cccc_hhhh_aaaa_rrrr
  221.                     No special conversion is necessary.
  222.  
  223.                After the representation is determined, padding occurs.  If
  224.                _o_u_t_s_...._wwww_iiii_dddd_tttt_hhhh_((((_)))) is greater than 0 and the representation contains
  225.                fewer than _o_u_t_s_...._wwww_iiii_dddd_tttt_hhhh_((((_)))) characters, then enough _o_u_t_s_...._ffff_iiii_llll_llll_((((_))))
  226.                characters are added to bring the total number of characters to
  227.                _iiii_oooo_ssss_...._wwww_iiii_dddd_tttt_hhhh_((((_)))).  If _iiii_oooo_ssss_::::_::::_llll_eeee_ffff_tttt is set in _iiii_oooo_ssss's format flags, the
  228.                sequence is left-adjusted, that is, characters are added after
  229.                the characters determined above.  If _iiii_oooo_ssss_::::_::::_rrrr_iiii_gggg_hhhh_tttt is set, the
  230.                padding is added before the characters determined above.  If
  231.                _iiii_oooo_ssss_::::_::::_iiii_nnnn_tttt_eeee_rrrr_nnnn_aaaa_llll is set, the padding is added after any leading
  232.                sign or base indication and before the characters that
  233.                represent the value.  _iiii_oooo_ssss_...._wwww_iiii_dddd_tttt_hhhh_((((_)))) is reset to 0, but all other
  234.                format variables are unchanged.  The resulting sequence
  235.                (padding plus representation) is inserted into _o_u_t_s_...._rrrr_dddd_bbbb_uuuu_ffff_((((_)))).
  236.  
  237.           _o_u_t_s_<<<<_<<<<_s_b
  238.                If _o_u_t_s_...._oooo_pppp_ffff_xxxx_((((_)))) returns non-zero, the sequence of characters
  239.                that can be fetched from _s_b are inserted into _o_u_t_s_...._rrrr_dddd_bbbb_uuuu_ffff_((((_)))).
  240.                Insertion stops when no more characters can be fetched from _s_b.
  241.                No padding is performed.  Always returns _o_u_t_s.
  242.  
  243.    UUUUnnnnffffoooorrrrmmmmaaaatttttttteeeedddd oooouuuuttttppppuuuutttt ffffuuuunnnnccccttttiiiioooonnnnssss::::
  244.           _o_u_t_s_p_====_&&&&_o_u_t_s_...._pppp_uuuu_tttt_((((_cccc_))))
  245.                Inserts _c into _o_u_t_s_...._rrrr_dddd_bbbb_uuuu_ffff_((((_)))).  Sets the error state if the
  246.                insertion fails.
  247.  
  248.           _o_u_t_s_p_====_&&&&_o_u_t_s_...._wwww_rrrr_iiii_tttt_eeee_((((_s_,,,,_n_))))
  249.                Inserts the _n characters starting at _s into _o_u_t_s_...._rrrr_dddd_bbbb_uuuu_ffff_((((_)))).
  250.                These characters may include zeros (i.e., _s need not be a null
  251.                terminated string).
  252.  
  253.    OOOOtttthhhheeeerrrr mmmmeeeemmmmbbbbeeeerrrr ffffuuuunnnnccccttttiiiioooonnnnssss::::
  254.           _o_u_t_s_p_====_&&&&_o_u_t_s_...._ffff_llll_uuuu_ssss_hhhh_((((_))))
  255.                Storing characters into a streambuf does not always cause them
  256.                to be consumed (e.g., written to the external file)
  257.                immediately.  _ffff_llll_uuuu_ssss_hhhh_((((_)))) causes any characters that may have been
  258.  
  259.  
  260.  
  261.                                                                         PPPPaaaaggggeeee 4444
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268. OOOOSSSSTTTTRRRREEEEAAAAMMMM((((3333CCCC++++++++))))                                                    OOOOSSSSTTTTRRRREEEEAAAAMMMM((((3333CCCC++++++++))))
  269.  
  270.  
  271.  
  272.                stored but not yet consumed to be consumed by calling
  273.                _o_u_t_s_...._rrrr_dddd_bbbb_uuuu_ffff_((((_))))_----_>>>>_ssss_yyyy_nnnn_cccc.
  274.  
  275.           _o_u_t_s_<<<<_<<<<_mmmm_aaaa_nnnn_iiii_pppp
  276.                Equivalent to _mmmm_aaaa_nnnn_iiii_pppp_((((_o_u_t_s_)))).  Syntactically this looks like an
  277.                insertion operation, but semantically it does an arbitrary
  278.                operation rather than converting _mmmm_aaaa_nnnn_iiii_pppp to a sequence of
  279.                characters as do the insertion operators.  Predefined
  280.                manipulators are described below.
  281.  
  282.    PPPPoooossssiiiittttiiiioooonnnniiiinnnngggg ffffuuuunnnnccccttttiiiioooonnnnssss::::
  283.           _o_u_t_s_p_====_&&&&_i_n_s_...._ssss_eeee_eeee_kkkk_pppp_((((_o_f_f_,,,,_d_i_r_))))
  284.                Repositions _o_u_t_s_...._rrrr_dddd_bbbb_uuuu_ffff_((((_))))'s put pointer.  See _ssss_bbbb_uuuu_ffff_...._pppp_uuuu_bbbb(3C++) for
  285.                a discussion of positioning.
  286.  
  287.           _o_u_t_s_p_====_&&&&_o_u_t_s_...._ssss_eeee_eeee_kkkk_pppp_((((_p_o_s_))))
  288.                Repositions _o_u_t_s_...._rrrr_dddd_bbbb_uuuu_ffff_((((_))))'s put pointer.  See _ssss_bbbb_uuuu_ffff_...._pppp_uuuu_bbbb(3C++) for
  289.                a discussion of positioning.
  290.  
  291.           _p_o_s_====_o_u_t_s_...._tttt_eeee_llll_llll_pppp_((((_))))
  292.                The current position of _o_u_t_s_...._rrrr_dddd_bbbb_uuuu_ffff_((((_))))'s put pointer.  See
  293.                _ssss_bbbb_uuuu_ffff_...._pppp_uuuu_bbbb(3C++) for a discussion of positioning.
  294.  
  295.    MMMMaaaannnniiiippppuuuullllaaaattttoooorrrrssss::::
  296.           _o_u_t_s_<<<<_<<<<_eeee_nnnn_dddd_llll
  297.                Ends a line by inserting a newline character and flushing.
  298.  
  299.           _o_u_t_s_<<<<_<<<<_eeee_nnnn_dddd_ssss
  300.                Ends a string by inserting a null (0) character.
  301.  
  302.           _o_u_t_s_<<<<_<<<<_ffff_llll_uuuu_ssss_hhhh
  303.                Flushes _o_u_t_s.
  304.  
  305.           _o_u_t_s_<<<<_<<<<_dddd_eeee_cccc
  306.                Sets the conversion base format flag to 10.  See _iiii_oooo_ssss(3C++).
  307.  
  308.           _o_u_t_s_<<<<_<<<<_hhhh_eeee_xxxx
  309.                Sets the conversion base format flag to 16.  See _iiii_oooo_ssss(3C++).
  310.  
  311.           _o_u_t_s_<<<<_<<<<_oooo_cccc_tttt
  312.                Sets the conversion base format flag to 8.  See _iiii_oooo_ssss(3C++).
  313.  
  314. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  315.      _iiii_oooo_ssss(3C++), _ssss_bbbb_uuuu_ffff_...._pppp_uuuu_bbbb(3C++), _mmmm_aaaa_nnnn_iiii_pppp(3C++)
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.                                                                         PPPPaaaaggggeeee 5555
  328.  
  329.  
  330.  
  331.